home *** CD-ROM | disk | FTP | other *** search
/ Developer CD Series 1997 July: Mac OS SDK / Dev.CD Jul 97 SDK2.toast / Development Kits (Disc 2) / Thread Manager / Thread Manager 2.1.1d1+ / ThreadedSort / README next >
Encoding:
Text File  |  1995-04-28  |  3.8 KB  |  93 lines  |  [ttro/ttxt]
  1. README for SortPicts 3.0
  2. November 16, 1994
  3. Randy Thelen
  4. AppleLink: RANDOM
  5. Internet: random@apple.com
  6.  
  7. SortPicts is an entertaining application which demonstrates how easy it is to use threads within your application.
  8.  
  9. There are a couple of gotcha's with the build process:
  10. •    If your version of MetroWerks is earlier than 1.1, you may need to rebuild the projects yourself.  If that's the case, you'll find the complete listing of included files and settings at the bottom of this document.
  11. •    If you are building with Think-C, you will need to construct your own projects.  In that case, you'll want to follow the advice at the bottom of this document regarding building a SortPicts project.
  12. •    Various MPW versions and headers may cause you random headaches.  The supplied version of SortPicts sources were built with the 3.4a7 MPW Shell from ETO #16 along with the headers from that release.  If you are using a different version, you may experience problems.
  13.  
  14. Making a SortPicts project.
  15.     The following files were included to make the SortPicts projects:
  16. For both 68K & PPC:
  17.     SortPictsApp.cp
  18.     SortPicts.cp
  19.     SortPicts2.cp
  20.     SortPicts3.cp
  21.     SortPicts4.cp
  22.     SortPicts5.cp
  23.     SortPictsThreads.cp
  24.     HeapSort.cp
  25.     QuickSort.cp
  26.     ShellSort.cp
  27.     AppleEventHandling.cp
  28.     SprocketMain.cp
  29.     DialogUtils.cp
  30.     Preferences.cp
  31.     SplashWindow.cp
  32.     Window.cp
  33.     SortPicts.rsrc
  34.     Sprocket.rsrc
  35. For 68K the following libraries were used:
  36.     ANSI (4i) C.68K.Lib
  37.     CPlusPlus.lib
  38.     MacOS.lib
  39. For PPC the following libraries were used:
  40.     InterfaceLib
  41.     ANSI C.PPC.Lib
  42.     MWCRuntime.Lib
  43.     AOCELib            -- Weak link
  44.     DragLib            -- Weak link
  45.     ThreadsLib        -- Weak link
  46.  
  47. There is a precompiled file that will greatly enhance your build time if you go ahead and precompile it.  The file is located in the "Precompiled Headers" folder.  It is a .cp file and will build under MetroWerks correctly.  If you don't already know, you'll need to build two files, one for 68K and one for PPC.  The names that we suggest (like, we used these names in the supplied projects) are SortPictsPrecompileMW68K and SortPictsPrecompileMWPPC.  Although, you're free to make them Cat and Mouse.  We really don't care.
  48.  
  49.     The following "settings" were used to build the file:
  50. Language Settings:
  51.     Activate C++ Compiler
  52.     Require Function Prototypes
  53.     Enable MPW Pointer Type Rules
  54.     <Don't forget the beauty of precompiled headers!>
  55. Warnings:
  56.     Turn all the warnings on -- that's just good advice
  57. Compiler:
  58.     4 byte ints
  59.     Small Code Model
  60.     68K Struct Alignment, even with the PPC version
  61.     68020 code generation, not with the PPC version  ;-)
  62.     Peephole Optimizer
  63.     CSE Optimizer
  64. Linker Options:
  65.     Use SYM file generation only if you need it ... if you find a bug, you might think to let me know  -- Random
  66. Project:
  67.     Build an application
  68.     Call it Cat, Mouse, or SortPicts68K or SortPictsPPC  -- one or the other, MPW builds "SortPicts"
  69.     Creator 'RnDm', type 'APPL'
  70.     Prefered heap size 2000K, minimum heap size 1000K
  71.     Other SIZE resource options:
  72.         dontSaveScreen,
  73.         acceptSuspendResumeEvents,
  74.         enableOptionSwitch,
  75.         canBackground,                /* Can properly use background null events    */
  76.         doesActivateOnFGSwitch,        /* We do our own activate/deactivate; don't fake us out */
  77.         backgroundAndForeground,    /* This is definitely not a background-only application! */
  78.         dontGetFrontClicks,            /* Change this is if you want "do first click" behavior like the Finder */
  79.         ignoreAppDiedEvents,        /* Essentially, I'm not a debugger (sub-launching) */
  80.         is32BitCompatible,            /* This app can be run in 32-bit address space */
  81.         isHighLevelEventAware,        /* does Post/AcceptHighLevelEvent */
  82.         localAndRemoteHLEvents,
  83.         notStationeryAware,
  84.         dontUseTextEditServices
  85. No additional access paths were necessary for this build.
  86. For the PowerPC version, the following additional steps may be helpful:
  87.     There were no variations on the default settings for a PPC build file:
  88.         64K stack size and  main entry point is __start.
  89.  
  90. “Keep on Threadin’”
  91. Randy & Dave
  92.  
  93.